SparkN0de-git - /page/blob.mu

Tff7b72import T7ee787html

Tff7b72import T7ee787io

Tff7b72import T7ee787logging

Tff7b72import T7ee787os

Tff7b72import T7ee787re

Tff7b72import T7ee787shutil

Tff7b72import T7ee787threading

Tff7b72import T7ee787zipfile

Tff7b72import T7ee787requests

Tff7b72from T7ee787meshchatxT7ee787.T7ee787srcT7ee787.T7ee787backendT7ee787.T7ee787markdown_renderer Tff7b72import Te6edf3MarkdownRenderer

Tff7b72class T56d364DocsManagerTb4b4b4:

Tff7b72def Tff7b72__init__Tb4b4b4(Tff7b72selfTb4b4b4, Te6edf3configTb4b4b4, Te6edf3public_dirTb4b4b4, Te6edf3project_rootTff7b72=Tff7b72NoneTb4b4b4, Te6edf3storage_dirTff7b72=Tff7b72NoneTb4b4b4)Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ffconfig Tff7b72= Te6edf3config

Tff7b72selfTff7b72.Td2a8ffpublic_dir Tff7b72= Te6edf3public_dir

Tff7b72selfTff7b72.Td2a8ffproject_root Tff7b72= Te6edf3project_root

Tff7b72selfTff7b72.Td2a8ffstorage_dir Tff7b72= Te6edf3storage_dir

T8b949e# Determine docs directories

Tff7b72if Tff7b72selfTff7b72.Td2a8ffstorage_dirTb4b4b4:

Tff7b72selfTff7b72.Td2a8ffdocs_base_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffstorage_dirTb4b4b4, Ta5d6ff"Ta5d6ffreticulum-docsTa5d6ff"Tb4b4b4)

Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffstorage_dirTb4b4b4, Ta5d6ff"Ta5d6ffmeshchatx-docsTa5d6ff"Tb4b4b4)

Tff7b72elseTb4b4b4:

Tff7b72selfTff7b72.Td2a8ffdocs_base_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffpublic_dirTb4b4b4, Ta5d6ff"Ta5d6ffreticulum-docsTa5d6ff"Tb4b4b4)

Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffpublic_dirTb4b4b4, Ta5d6ff"Ta5d6ffmeshchatx-docsTa5d6ff"Tb4b4b4)

T8b949e# The actual docs are served from this directory

T8b949e# We will use a 'current' subdirectory for the active version

Tff7b72selfTff7b72.Td2a8ffdocs_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6ffcurrentTa5d6ff"Tb4b4b4)

Tff7b72selfTff7b72.Td2a8ffversions_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6ffversionsTa5d6ff"Tb4b4b4)

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6ffidleTa5d6ff"

Tff7b72selfTff7b72.Td2a8ffdownload_progress Tff7b72= T79c0ff0

Tff7b72selfTff7b72.Td2a8fflast_error Tff7b72= Tff7b72None

T8b949e# Ensure docs directories exist

Tff7b72tryTb4b4b4:

Tff7b72for Te6edf3d Tff7b72in Tb4b4b4[

Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4,

Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4,

Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4,

Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4,

Tb4b4b4]Tb4b4b4:

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3dTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffmakedirsTb4b4b4(Te6edf3dTb4b4b4)

T8b949e# If 'current' doesn't exist but we have versions, pick the latest one

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4) Tff7b72or Tff7b72not Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ff_update_current_linkTb4b4b4(Tb4b4b4)

Tff7b72except Tf85149OSError Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to create documentation directories: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72selfTff7b72.Td2a8fflast_error Tff7b72= Tffa657strTb4b4b4(Te6edf3eTb4b4b4)

T8b949e# Initial population of MeshChatX docs

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4) Tff7b72and Te6edf3osTff7b72.Td2a8ffaccessTb4b4b4(

Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4,

Te6edf3osTff7b72.Td2a8ffW_OKTb4b4b4,

Tb4b4b4)Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ffpopulate_meshchatx_docsTb4b4b4(Tb4b4b4)

Tff7b72def Td2a8ff_update_current_linkTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3versionTff7b72=Tff7b72NoneTb4b4b4)Tb4b4b4:

T8b949e"""Updates the 'current' directory to point to the specified version or the latest one."""

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4)Tb4b4b4:

Tff7b72return

Te6edf3versions Tff7b72= Tff7b72selfTff7b72.Td2a8ffget_available_versionsTb4b4b4(Tb4b4b4)

Tff7b72if Tff7b72not Te6edf3versionsTb4b4b4:

Tff7b72return

Te6edf3target_version Tff7b72= Te6edf3version

Tff7b72if Tff7b72not Te6edf3target_versionTb4b4b4:

T8b949e# Pick latest version (alphabetically)

Te6edf3target_version Tff7b72= Te6edf3versionsTb4b4b4[Tff7b72-T79c0ff1Tb4b4b4]

Te6edf3version_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4, Te6edf3target_versionTb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3version_pathTb4b4b4)Tb4b4b4:

Tff7b72return

T8b949e# On some systems symlinks might fail or be restricted, so we use a directory copy or move

T8b949e# but for now let's try to just use the path directly if possible.

T8b949e# However, meshchat.py uses self.docs_dir for the static route.

T8b949e# To make it simple and robust across platforms, we'll clear 'current' and copy the version

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffislinkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffunlinkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Tff7b72tryTb4b4b4:

T8b949e# Try symlink first as it's efficient

T8b949e# We use a relative path for the symlink target to make the storage directory portable

T8b949e# version_path is relative to CWD, so we need it relative to the parent of self.docs_dir

Te6edf3rel_target Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffrelpathTb4b4b4(Te6edf3version_pathTb4b4b4, Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffdirnameTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4)

Te6edf3osTff7b72.Td2a8ffsymlinkTb4b4b4(Te6edf3rel_targetTb4b4b4, Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Tff7b72except Tb4b4b4(Tf85149OSErrorTb4b4b4, Tf85149AttributeErrorTb4b4b4)Tb4b4b4:

T8b949e# Fallback to copy

Te6edf3shutilTff7b72.Td2a8ffcopytreeTb4b4b4(Te6edf3version_pathTb4b4b4, Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Tff7b72def Td2a8ffget_available_versionsTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4)Tb4b4b4:

Tff7b72return Tb4b4b4[Tb4b4b4]

Te6edf3versions Tff7b72= Tb4b4b4[

Te6edf3d

Tff7b72for Te6edf3d Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4, Te6edf3dTb4b4b4)Tb4b4b4)

Tb4b4b4]

Tff7b72return Tffa657sortedTb4b4b4(Te6edf3versionsTb4b4b4)

Tff7b72def Td2a8ffget_current_versionTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72return Tff7b72None

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffislinkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72return Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffbasenameTb4b4b4(Te6edf3osTff7b72.Td2a8ffreadlinkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4)

T8b949e# If it's a copy, we might need a metadata file to know which version it is

Te6edf3version_file Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4, Ta5d6ff"Ta5d6ff.versionTa5d6ff"Tb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3version_fileTb4b4b4)Tb4b4b4:

Tff7b72tryTb4b4b4:

Tff7b72with Tffa657openTb4b4b4(Te6edf3version_fileTb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Tff7b72return Te6edf3fTff7b72.Td2a8ffreadTb4b4b4(Tb4b4b4)Tff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)

Tff7b72except Tf85149OSErrorTb4b4b4:

Tff7b72pass

Tff7b72return Ta5d6ff"Ta5d6ffunknownTa5d6ff"

Tff7b72def Td2a8ffswitch_versionTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3versionTb4b4b4)Tb4b4b4:

Tff7b72if Te6edf3version Tff7b72in Tff7b72selfTff7b72.Td2a8ffget_available_versionsTb4b4b4(Tb4b4b4)Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ff_update_current_linkTb4b4b4(Te6edf3versionTb4b4b4)

Tff7b72return Tff7b72True

Tff7b72return Tff7b72False

Tff7b72def Td2a8ffdelete_versionTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3versionTb4b4b4)Tb4b4b4:

T8b949e"""Deletes a specific version of documentation."""

Tff7b72if Te6edf3version Tff7b72not Tff7b72in Tff7b72selfTff7b72.Td2a8ffget_available_versionsTb4b4b4(Tb4b4b4)Tb4b4b4:

Tff7b72return Tff7b72False

Te6edf3version_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4, Te6edf3versionTb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3version_pathTb4b4b4)Tb4b4b4:

Tff7b72return Tff7b72False

Tff7b72tryTb4b4b4:

T8b949e# If the deleted version is the current one, unlink 'current' first

Te6edf3current_version Tff7b72= Tff7b72selfTff7b72.Td2a8ffget_current_versionTb4b4b4(Tb4b4b4)

Tff7b72if Te6edf3current_version Tff7b72== Te6edf3versionTb4b4b4:

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffislinkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffunlinkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Te6edf3version_pathTb4b4b4)

T8b949e# If we just deleted the current version, try to pick another one as current

Tff7b72if Te6edf3current_version Tff7b72== Te6edf3versionTb4b4b4:

Tff7b72selfTff7b72.Td2a8ff_update_current_linkTb4b4b4(Tb4b4b4)

Tff7b72return Tff7b72True

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to delete docs version Tffd700{Te6edf3versionTffd700}Ta5d6ff: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Tff7b72False

Tff7b72def Td2a8ffclear_reticulum_docsTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

T8b949e"""Clears all Reticulum documentation and versions."""

Tff7b72tryTb4b4b4:

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4)Tb4b4b4:

T8b949e# We don't want to delete the base dir itself, just its contents

T8b949e# except possibly some metadata if we added any.

T8b949e# Actually, deleting everything inside reticulum-docs is fine.

Tff7b72for Te6edf3item Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4)Tb4b4b4:

Te6edf3item_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Te6edf3itemTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffislinkTb4b4b4(Te6edf3item_pathTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffunlinkTb4b4b4(Te6edf3item_pathTb4b4b4)

Tff7b72elif Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3item_pathTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Te6edf3item_pathTb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3osTff7b72.Td2a8ffremoveTb4b4b4(Te6edf3item_pathTb4b4b4)

T8b949e# Re-create required subdirectories

Tff7b72for Te6edf3d Tff7b72in Tb4b4b4[Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4, Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4]Tb4b4b4:

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3dTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffmakedirsTb4b4b4(Te6edf3dTb4b4b4)

Tff7b72selfTff7b72.Td2a8ffconfigTff7b72.Td2a8ffdocs_downloadedTff7b72.Td2a8ffsetTb4b4b4(Tff7b72FalseTb4b4b4)

Tff7b72return Tff7b72True

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to clear Reticulum docs: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Tff7b72False

Tff7b72def Td2a8ffpopulate_meshchatx_docsTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

T8b949e"""Populates meshchatx-docs from the project's docs folder."""

T8b949e# Try to find docs folder in several places

Te6edf3search_paths Tff7b72= Tb4b4b4[Tb4b4b4]

Tff7b72if Tff7b72selfTff7b72.Td2a8ffproject_rootTb4b4b4:

Te6edf3search_pathsTff7b72.Td2a8ffappendTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffproject_rootTb4b4b4, Ta5d6ff"Ta5d6ffdocsTa5d6ff"Tb4b4b4)Tb4b4b4)

T8b949e# Also try in the public directory

Te6edf3search_pathsTff7b72.Td2a8ffappendTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffpublic_dirTb4b4b4, Ta5d6ff"Ta5d6ffmeshchatx-docsTa5d6ff"Tb4b4b4)Tb4b4b4)

T8b949e# Also try relative to this file

T8b949e# This file is in meshchatx/src/backend/docs_manager.py

T8b949e# Project root is 3 levels up

Te6edf3this_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffdirnameTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffabspathTb4b4b4(Tff7b72__file__Tb4b4b4)Tb4b4b4)

Te6edf3search_pathsTff7b72.Td2a8ffappendTb4b4b4(

Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffabspathTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3this_dirTb4b4b4, Ta5d6ff"Ta5d6ff..Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff..Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff..Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffdocsTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3src_docs Tff7b72= Tff7b72None

Tff7b72for Te6edf3path Tff7b72in Te6edf3search_pathsTb4b4b4:

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3pathTb4b4b4) Tff7b72and Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3pathTb4b4b4)Tb4b4b4:

Te6edf3src_docs Tff7b72= Te6edf3path

Tff7b72break

Tff7b72if Tff7b72not Te6edf3src_docsTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffwarningTb4b4b4(Ta5d6ff"Ta5d6ffMeshChatX docs source directory not found.Ta5d6ff"Tb4b4b4)

Tff7b72return

Tff7b72tryTb4b4b4:

Tff7b72for Te6edf3file Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Te6edf3src_docsTb4b4b4)Tb4b4b4:

Tff7b72if Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Ta5d6ff"Ta5d6ff.mdTa5d6ff"Tb4b4b4) Tff7b72or Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Ta5d6ff"Ta5d6ff.txtTa5d6ff"Tb4b4b4)Tb4b4b4:

Te6edf3src_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3src_docsTb4b4b4, Te6edf3fileTb4b4b4)

Te6edf3dest_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4, Te6edf3fileTb4b4b4)

T8b949e# Only copy if source and destination are different

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffabspathTb4b4b4(Te6edf3src_pathTb4b4b4) Tff7b72!= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffabspathTb4b4b4(

Te6edf3dest_pathTb4b4b4,

Tb4b4b4) Tff7b72and Te6edf3osTff7b72.Td2a8ffaccessTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4, Te6edf3osTff7b72.Td2a8ffW_OKTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopy2Tb4b4b4(Te6edf3src_pathTb4b4b4, Te6edf3dest_pathTb4b4b4)

T8b949e# Also pre-render to HTML for easy sharing/viewing

Tff7b72tryTb4b4b4:

Tff7b72with Tffa657openTb4b4b4(Te6edf3src_pathTb4b4b4, Te6edf3encodingTff7b72=Ta5d6ff"Ta5d6ffutf-8Ta5d6ff"Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3content Tff7b72= Te6edf3fTff7b72.Td2a8ffreadTb4b4b4(Tb4b4b4)

Te6edf3html_content Tff7b72= Te6edf3MarkdownRendererTff7b72.Td2a8ffrenderTb4b4b4(Te6edf3contentTb4b4b4)

T8b949e# Basic HTML wrapper for standalone viewing

Te6edf3full_html Tff7b72= Ta5d6fffTa5d6ff"""Ta5d6ff<!DOCTYPE html>

Ta5d6ff<html class=Ta5d6ff"Ta5d6ffdarkTa5d6ff"Ta5d6ff>

Ta5d6ff<head>

Ta5d6ff <meta charset=Ta5d6ff"Ta5d6ffutf-8Ta5d6ff"Ta5d6ff>

Ta5d6ff <meta name=Ta5d6ff"Ta5d6ffviewportTa5d6ff"Ta5d6ff content=Ta5d6ff"Ta5d6ffwidth=device-width, initial-scale=1Ta5d6ff"Ta5d6ff>

Ta5d6ff <title>Tffd700{Te6edf3fileTffd700}Ta5d6ff</title>

Ta5d6ff <script src=Ta5d6ff"Ta5d6ff../assets/js/tailwindcss/tailwind-v3.4.3-forms-v0.5.7.jsTa5d6ff"Ta5d6ff></script>

Ta5d6ff <style>

Ta5d6ff body Tffea00{{Ta5d6ff background-color: #111827; color: #f3f4f6; Tffea00}}

Ta5d6ff </style>

Ta5d6ff</head>

Ta5d6ff<body class=Ta5d6ff"Ta5d6ffp-4 md:p-8 max-w-4xl mx-autoTa5d6ff"Ta5d6ff>

Ta5d6ff <div class=Ta5d6ff"Ta5d6ffmax-w-none break-wordsTa5d6ff"Ta5d6ff>

Ta5d6ff Tffd700{Te6edf3html_contentTffd700}

Ta5d6ff </div>

Ta5d6ff</body>

Ta5d6ff</html>Ta5d6ff"""

Te6edf3html_file Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffsplitextTb4b4b4(Te6edf3fileTb4b4b4)Tb4b4b4[T79c0ff0Tb4b4b4] Tff7b72+ Ta5d6ff"Ta5d6ff.htmlTa5d6ff"

Tff7b72with Tffa657openTb4b4b4(

Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4, Te6edf3html_fileTb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffwTa5d6ff"Tb4b4b4,

Te6edf3encodingTff7b72=Ta5d6ff"Ta5d6ffutf-8Ta5d6ff"Tb4b4b4,

Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3fTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3full_htmlTb4b4b4)

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to render Tffd700{Te6edf3fileTffd700}Ta5d6ff to HTML: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to populate MeshChatX docs: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72def Td2a8ffget_statusTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

Tff7b72return Tb4b4b4{

Ta5d6ff"Ta5d6ffstatusTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8ffdownload_statusTb4b4b4,

Ta5d6ff"Ta5d6ffprogressTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8ffdownload_progressTb4b4b4,

Ta5d6ff"Ta5d6fflast_errorTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8fflast_errorTb4b4b4,

Ta5d6ff"Ta5d6ffhas_docsTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8ffhas_docsTb4b4b4(Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffhas_meshchatx_docsTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8ffhas_meshchatx_docsTb4b4b4(Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffversionsTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8ffget_available_versionsTb4b4b4(Tb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6ffcurrent_versionTa5d6ff"Tb4b4b4: Tff7b72selfTff7b72.Td2a8ffget_current_versionTb4b4b4(Tb4b4b4)Tb4b4b4,

Tb4b4b4}

Tff7b72def Td2a8ffhas_meshchatx_docsTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

Tff7b72return Tb4b4b4(

Tffa657anyTb4b4b4(

Te6edf3fTff7b72.Td2a8ffendswithTb4b4b4(Tb4b4b4(Ta5d6ff"Ta5d6ff.mdTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff.txtTa5d6ff"Tb4b4b4)Tb4b4b4) Tff7b72for Te6edf3f Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)

Tb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)

Tff7b72else Tff7b72False

Tb4b4b4)

Tff7b72def Td2a8ffget_meshchatx_docs_listTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

Te6edf3docs Tff7b72= Tb4b4b4[Tb4b4b4]

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)Tb4b4b4:

Tff7b72return Te6edf3docs

Te6edf3docsTff7b72.Td2a8ffextendTb4b4b4(

Tb4b4b4{

Ta5d6ff"Ta5d6ffnameTa5d6ff"Tb4b4b4: Te6edf3fileTb4b4b4,

Ta5d6ff"Ta5d6ffpathTa5d6ff"Tb4b4b4: Te6edf3fileTb4b4b4,

Ta5d6ff"Ta5d6fftypeTa5d6ff"Tb4b4b4: Ta5d6ff"Ta5d6ffmarkdownTa5d6ff" Tff7b72if Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Ta5d6ff"Ta5d6ff.mdTa5d6ff"Tb4b4b4) Tff7b72else Ta5d6ff"Ta5d6fftextTa5d6ff"Tb4b4b4,

Tb4b4b4}

Tff7b72for Te6edf3file Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)

Tff7b72if Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Tb4b4b4(Ta5d6ff"Ta5d6ff.mdTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff.txtTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4)

Tff7b72return Tffa657sortedTb4b4b4(Te6edf3docsTb4b4b4, Te6edf3keyTff7b72=Tff7b72lambda Te6edf3xTb4b4b4: Te6edf3xTb4b4b4[Ta5d6ff"Ta5d6ffnameTa5d6ff"Tb4b4b4]Tb4b4b4)

Tff7b72def Td2a8ffget_doc_contentTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3pathTb4b4b4)Tb4b4b4:

Te6edf3full_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4, Te6edf3pathTb4b4b4)

Tff7b72if Tff7b72not Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3full_pathTb4b4b4)Tb4b4b4:

Tff7b72return Tff7b72None

Tff7b72with Tffa657openTb4b4b4(Te6edf3full_pathTb4b4b4, Te6edf3encodingTff7b72=Ta5d6ff"Ta5d6ffutf-8Ta5d6ff"Tb4b4b4, Te6edf3errorsTff7b72=Ta5d6ff"Ta5d6ffignoreTa5d6ff"Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3content Tff7b72= Te6edf3fTff7b72.Td2a8ffreadTb4b4b4(Tb4b4b4)

Tff7b72if Te6edf3pathTff7b72.Td2a8ffendswithTb4b4b4(Ta5d6ff"Ta5d6ff.mdTa5d6ff"Tb4b4b4)Tb4b4b4:

Tff7b72return Tb4b4b4{

Ta5d6ff"Ta5d6ffcontentTa5d6ff"Tb4b4b4: Te6edf3contentTb4b4b4,

Ta5d6ff"Ta5d6ffhtmlTa5d6ff"Tb4b4b4: Te6edf3MarkdownRendererTff7b72.Td2a8ffrenderTb4b4b4(Te6edf3contentTb4b4b4)Tb4b4b4,

Ta5d6ff"Ta5d6fftypeTa5d6ff"Tb4b4b4: Ta5d6ff"Ta5d6ffmarkdownTa5d6ff"Tb4b4b4,

Tb4b4b4}

Tff7b72return Tb4b4b4{

Ta5d6ff"Ta5d6ffcontentTa5d6ff"Tb4b4b4: Te6edf3contentTb4b4b4,

Ta5d6ff"Ta5d6ffhtmlTa5d6ff"Tb4b4b4: Ta5d6fffTa5d6ff"Ta5d6ff<pre class=Ta5d6ff'Ta5d6ffwhitespace-pre-wrap font-monoTa5d6ff'Ta5d6ff>Tffd700{Te6edf3htmlTff7b72.Td2a8ffescapeTb4b4b4(Te6edf3contentTb4b4b4)Tffd700}Ta5d6ff</pre>Ta5d6ff"Tb4b4b4,

Ta5d6ff"Ta5d6fftypeTa5d6ff"Tb4b4b4: Ta5d6ff"Ta5d6fftextTa5d6ff"Tb4b4b4,

Tb4b4b4}

Tff7b72def Td2a8ffexport_docsTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

T8b949e"""Creates a zip of all docs and returns the bytes."""

Te6edf3buffer Tff7b72= Te6edf3ioTff7b72.Td2a8ffBytesIOTb4b4b4(Tb4b4b4)

Tff7b72with Te6edf3zipfileTff7b72.Td2a8ffZipFileTb4b4b4(Te6edf3bufferTb4b4b4, Ta5d6ff"Ta5d6ffwTa5d6ff"Tb4b4b4, Te6edf3zipfileTff7b72.Td2a8ffZIP_DEFLATEDTb4b4b4) Tff7b72as Te6edf3zip_fileTb4b4b4:

T8b949e# Add reticulum docs

Tff7b72for Te6edf3rootTb4b4b4, Te6edf3_Tb4b4b4, Te6edf3files Tff7b72in Te6edf3osTff7b72.Td2a8ffwalkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72for Te6edf3file Tff7b72in Te6edf3filesTb4b4b4:

Te6edf3file_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3rootTb4b4b4, Te6edf3fileTb4b4b4)

Te6edf3rel_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(

Ta5d6ff"Ta5d6ffreticulum-docsTa5d6ff"Tb4b4b4,

Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffrelpathTb4b4b4(Te6edf3file_pathTb4b4b4, Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3zip_fileTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3file_pathTb4b4b4, Te6edf3rel_pathTb4b4b4)

T8b949e# Add meshchatx docs

Tff7b72for Te6edf3rootTb4b4b4, Te6edf3_Tb4b4b4, Te6edf3files Tff7b72in Te6edf3osTff7b72.Td2a8ffwalkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)Tb4b4b4:

Tff7b72for Te6edf3file Tff7b72in Te6edf3filesTb4b4b4:

Te6edf3file_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3rootTb4b4b4, Te6edf3fileTb4b4b4)

Te6edf3rel_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(

Ta5d6ff"Ta5d6ffmeshchatx-docsTa5d6ff"Tb4b4b4,

Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffrelpathTb4b4b4(Te6edf3file_pathTb4b4b4, Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3zip_fileTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3file_pathTb4b4b4, Te6edf3rel_pathTb4b4b4)

Te6edf3bufferTff7b72.Td2a8ffseekTb4b4b4(T79c0ff0Tb4b4b4)

Tff7b72return Te6edf3bufferTff7b72.Td2a8ffgetvalueTb4b4b4(Tb4b4b4)

Tff7b72def Td2a8ffsearchTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3queryTb4b4b4, Te6edf3langTff7b72=Ta5d6ff"Ta5d6ffenTa5d6ff"Tb4b4b4)Tb4b4b4:

Tff7b72if Tff7b72not Te6edf3queryTb4b4b4:

Tff7b72return Tb4b4b4[Tb4b4b4]

Te6edf3results Tff7b72= Tb4b4b4[Tb4b4b4]

Te6edf3query Tff7b72= Te6edf3queryTff7b72.Td2a8fflowerTb4b4b4(Tb4b4b4)

T8b949e# 1. Search MeshChatX Docs first

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)Tb4b4b4:

Tff7b72for Te6edf3file Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4)Tb4b4b4:

Tff7b72if Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Tb4b4b4(Ta5d6ff"Ta5d6ff.mdTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff.txtTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4:

Te6edf3file_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffmeshchatx_docs_dirTb4b4b4, Te6edf3fileTb4b4b4)

Tff7b72tryTb4b4b4:

Tff7b72with Tffa657openTb4b4b4(

Te6edf3file_pathTb4b4b4,

Te6edf3encodingTff7b72=Ta5d6ff"Ta5d6ffutf-8Ta5d6ff"Tb4b4b4,

Te6edf3errorsTff7b72=Ta5d6ff"Ta5d6ffignoreTa5d6ff"Tb4b4b4,

Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3content Tff7b72= Te6edf3fTff7b72.Td2a8ffreadTb4b4b4(Tb4b4b4)

Tff7b72if Te6edf3query Tff7b72in Te6edf3contentTff7b72.Td2a8fflowerTb4b4b4(Tb4b4b4)Tb4b4b4:

T8b949e# Simple snippet

Te6edf3idx Tff7b72= Te6edf3contentTff7b72.Td2a8fflowerTb4b4b4(Tb4b4b4)Tff7b72.Td2a8fffindTb4b4b4(Te6edf3queryTb4b4b4)

Te6edf3start Tff7b72= Tffa657maxTb4b4b4(T79c0ff0Tb4b4b4, Te6edf3idx Tff7b72- T79c0ff80Tb4b4b4)

Te6edf3end Tff7b72= Tffa657minTb4b4b4(Tffa657lenTb4b4b4(Te6edf3contentTb4b4b4)Tb4b4b4, Te6edf3idx Tff7b72+ Tffa657lenTb4b4b4(Te6edf3queryTb4b4b4) Tff7b72+ T79c0ff120Tb4b4b4)

Te6edf3snippet Tff7b72= Te6edf3contentTb4b4b4[Te6edf3startTb4b4b4:Te6edf3endTb4b4b4]

Tff7b72if Te6edf3start Tff7b72> T79c0ff0Tb4b4b4:

Te6edf3snippet Tff7b72= Ta5d6ff"Ta5d6ff...Ta5d6ff" Tff7b72+ Te6edf3snippet

Tff7b72if Te6edf3end Tff7b72< Tffa657lenTb4b4b4(Te6edf3contentTb4b4b4)Tb4b4b4:

Te6edf3snippet Tff7b72= Te6edf3snippet Tff7b72+ Ta5d6ff"Ta5d6ff...Ta5d6ff"

Te6edf3resultsTff7b72.Td2a8ffappendTb4b4b4(

Tb4b4b4{

Ta5d6ff"Ta5d6fftitleTa5d6ff"Tb4b4b4: Te6edf3fileTb4b4b4,

Ta5d6ff"Ta5d6ffpathTa5d6ff"Tb4b4b4: Ta5d6fffTa5d6ff"Ta5d6ff/meshchatx-docs/Tffd700{Te6edf3fileTffd700}Ta5d6ff"Tb4b4b4,

Ta5d6ff"Ta5d6ffsnippetTa5d6ff"Tb4b4b4: Te6edf3snippetTb4b4b4,

Ta5d6ff"Ta5d6ffsourceTa5d6ff"Tb4b4b4: Ta5d6ff"Ta5d6ffMeshChatXTa5d6ff"Tb4b4b4,

Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffError searching MeshChatX doc Tffd700{Te6edf3fileTffd700}Ta5d6ff: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

T8b949e# 2. Search Reticulum Docs

Tff7b72if Tff7b72selfTff7b72.Td2a8ffhas_docsTb4b4b4(Tb4b4b4)Tb4b4b4:

T8b949e# Known language suffixes in Reticulum docs

Te6edf3known_langs Tff7b72= Tb4b4b4[Ta5d6ff"Ta5d6ffdeTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffesTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffjpTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffnlTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffplTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffpt-brTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftrTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffukTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffzh-cnTa5d6ff"Tb4b4b4]

T8b949e# Determine files to search

Te6edf3target_files Tff7b72= Tb4b4b4[Tb4b4b4]

Tff7b72tryTb4b4b4:

Tff7b72for Te6edf3rootTb4b4b4, Te6edf3_Tb4b4b4, Te6edf3files Tff7b72in Te6edf3osTff7b72.Td2a8ffwalkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72for Te6edf3file Tff7b72in Te6edf3filesTb4b4b4:

Tff7b72if Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Ta5d6ff"Ta5d6ff.htmlTa5d6ff"Tb4b4b4)Tb4b4b4:

T8b949e# Basic filtering for language if possible

Tff7b72if Te6edf3lang Tff7b72!= Ta5d6ff"Ta5d6ffenTa5d6ff"Tb4b4b4:

Tff7b72if Ta5d6fffTa5d6ff"Ta5d6ff_Tffd700{Te6edf3langTffd700}Ta5d6ff.htmlTa5d6ff" Tff7b72in Te6edf3fileTb4b4b4:

Te6edf3target_filesTff7b72.Td2a8ffappendTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3rootTb4b4b4, Te6edf3fileTb4b4b4)Tb4b4b4)

Tff7b72elseTb4b4b4:

T8b949e# For English, we want files that DON'T have a language suffix

T8b949e# This is a bit heuristic

Te6edf3has_lang_suffix Tff7b72= Tff7b72False

Tff7b72for Te6edf3lang_code Tff7b72in Te6edf3known_langsTb4b4b4:

Tff7b72if Ta5d6fffTa5d6ff"Ta5d6ff_Tffd700{Te6edf3lang_codeTffd700}Ta5d6ff.htmlTa5d6ff" Tff7b72in Te6edf3fileTb4b4b4:

Te6edf3has_lang_suffix Tff7b72= Tff7b72True

Tff7b72break

Tff7b72if Tff7b72not Te6edf3has_lang_suffixTb4b4b4:

Te6edf3target_filesTff7b72.Td2a8ffappendTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3rootTb4b4b4, Te6edf3fileTb4b4b4)Tb4b4b4)

T8b949e# If we found nothing for a specific language, fall back to English ONLY

Tff7b72if Tff7b72not Te6edf3target_files Tff7b72and Te6edf3lang Tff7b72!= Ta5d6ff"Ta5d6ffenTa5d6ff"Tb4b4b4:

Tff7b72for Te6edf3rootTb4b4b4, Te6edf3_Tb4b4b4, Te6edf3files Tff7b72in Te6edf3osTff7b72.Td2a8ffwalkTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)Tb4b4b4:

Tff7b72for Te6edf3file Tff7b72in Te6edf3filesTb4b4b4:

Tff7b72if Te6edf3fileTff7b72.Td2a8ffendswithTb4b4b4(Ta5d6ff"Ta5d6ff.htmlTa5d6ff"Tb4b4b4)Tb4b4b4:

Te6edf3has_lang_suffix Tff7b72= Tff7b72False

Tff7b72for Te6edf3lang_code Tff7b72in Te6edf3known_langsTb4b4b4:

Tff7b72if Ta5d6fffTa5d6ff"Ta5d6ff_Tffd700{Te6edf3lang_codeTffd700}Ta5d6ff.htmlTa5d6ff" Tff7b72in Te6edf3fileTb4b4b4:

Te6edf3has_lang_suffix Tff7b72= Tff7b72True

Tff7b72break

Tff7b72if Tff7b72not Te6edf3has_lang_suffixTb4b4b4:

Te6edf3target_filesTff7b72.Td2a8ffappendTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3rootTb4b4b4, Te6edf3fileTb4b4b4)Tb4b4b4)

Tff7b72for Te6edf3file_path Tff7b72in Te6edf3target_filesTb4b4b4:

Tff7b72tryTb4b4b4:

Tff7b72with Tffa657openTb4b4b4(Te6edf3file_pathTb4b4b4, Te6edf3encodingTff7b72=Ta5d6ff"Ta5d6ffutf-8Ta5d6ff"Tb4b4b4, Te6edf3errorsTff7b72=Ta5d6ff"Ta5d6ffignoreTa5d6ff"Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3content Tff7b72= Te6edf3fTff7b72.Td2a8ffreadTb4b4b4(Tb4b4b4)

T8b949e# Very basic HTML tag removal for searching

Te6edf3text_content Tff7b72= Te6edf3reTff7b72.Td2a8ffsubTb4b4b4(Ta5d6ffrTa5d6ff"Ta5d6ff<[^>]+>Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff Ta5d6ff"Tb4b4b4, Te6edf3contentTb4b4b4)

Te6edf3text_content Tff7b72= Ta5d6ff"Ta5d6ff Ta5d6ff"Tff7b72.Td2a8ffjoinTb4b4b4(Te6edf3text_contentTff7b72.Td2a8ffsplitTb4b4b4(Tb4b4b4)Tb4b4b4)

Tff7b72if Te6edf3query Tff7b72in Te6edf3text_contentTff7b72.Td2a8fflowerTb4b4b4(Tb4b4b4)Tb4b4b4:

T8b949e# Find title

Te6edf3title_match Tff7b72= Te6edf3reTff7b72.Td2a8ffsearchTb4b4b4(

Ta5d6ffrTa5d6ff"Ta5d6ff<title>(.*?)</title>Ta5d6ff"Tb4b4b4,

Te6edf3contentTb4b4b4,

Te6edf3reTff7b72.Td2a8ffIGNORECASE Tff7b72| Te6edf3reTff7b72.Td2a8ffDOTALLTb4b4b4,

Tb4b4b4)

Te6edf3title Tff7b72= Tb4b4b4(

Te6edf3title_matchTff7b72.Td2a8ffgroupTb4b4b4(T79c0ff1Tb4b4b4)Tff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)

Tff7b72if Te6edf3title_match

Tff7b72else Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffbasenameTb4b4b4(Te6edf3file_pathTb4b4b4)

Tb4b4b4)

T8b949e# Remove " — Reticulum Network Stack ..." suffix often found in Sphinx docs

Te6edf3title Tff7b72= Te6edf3reTff7b72.Td2a8ffsubTb4b4b4(Ta5d6ffrTa5d6ff"Ta5d6ff\Ta5d6ffs+[Ta5d6ff\Ta5d6ffu2014-].*$Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff"Tb4b4b4, Te6edf3titleTb4b4b4)

T8b949e# Find snippet

Te6edf3idx Tff7b72= Te6edf3text_contentTff7b72.Td2a8fflowerTb4b4b4(Tb4b4b4)Tff7b72.Td2a8fffindTb4b4b4(Te6edf3queryTb4b4b4)

Te6edf3start Tff7b72= Tffa657maxTb4b4b4(T79c0ff0Tb4b4b4, Te6edf3idx Tff7b72- T79c0ff80Tb4b4b4)

Te6edf3end Tff7b72= Tffa657minTb4b4b4(Tffa657lenTb4b4b4(Te6edf3text_contentTb4b4b4)Tb4b4b4, Te6edf3idx Tff7b72+ Tffa657lenTb4b4b4(Te6edf3queryTb4b4b4) Tff7b72+ T79c0ff120Tb4b4b4)

Te6edf3snippet Tff7b72= Te6edf3text_contentTb4b4b4[Te6edf3startTb4b4b4:Te6edf3endTb4b4b4]

Tff7b72if Te6edf3start Tff7b72> T79c0ff0Tb4b4b4:

Te6edf3snippet Tff7b72= Ta5d6ff"Ta5d6ff...Ta5d6ff" Tff7b72+ Te6edf3snippet

Tff7b72if Te6edf3end Tff7b72< Tffa657lenTb4b4b4(Te6edf3text_contentTb4b4b4)Tb4b4b4:

Te6edf3snippet Tff7b72= Te6edf3snippet Tff7b72+ Ta5d6ff"Ta5d6ff...Ta5d6ff"

Te6edf3rel_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffrelpathTb4b4b4(Te6edf3file_pathTb4b4b4, Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4)

Te6edf3resultsTff7b72.Td2a8ffappendTb4b4b4(

Tb4b4b4{

Ta5d6ff"Ta5d6fftitleTa5d6ff"Tb4b4b4: Te6edf3titleTb4b4b4,

Ta5d6ff"Ta5d6ffpathTa5d6ff"Tb4b4b4: Ta5d6fffTa5d6ff"Ta5d6ff/reticulum-docs/Tffd700{Te6edf3rel_pathTffd700}Ta5d6ff"Tb4b4b4,

Ta5d6ff"Ta5d6ffsnippetTa5d6ff"Tb4b4b4: Te6edf3snippetTb4b4b4,

Ta5d6ff"Ta5d6ffsourceTa5d6ff"Tb4b4b4: Ta5d6ff"Ta5d6ffReticulumTa5d6ff"Tb4b4b4,

Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tff7b72if Tffa657lenTb4b4b4(Te6edf3resultsTb4b4b4) Tff7b72>Tff7b72= T79c0ff25Tb4b4b4: T8b949e# Limit results

Tff7b72break

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffError searching file Tffd700{Te6edf3file_pathTffd700}Ta5d6ff: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffSearch failed: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Te6edf3results

Tff7b72def Td2a8ffhas_docsTb4b4b4(Tff7b72selfTb4b4b4)Tb4b4b4:

T8b949e# Check if index.html exists in the docs folder or if we have any versions

Tff7b72return Tb4b4b4(

Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_dirTb4b4b4, Ta5d6ff"Ta5d6ffindex.htmlTa5d6ff"Tb4b4b4)Tb4b4b4)

Tff7b72or Tffa657lenTb4b4b4(Tff7b72selfTff7b72.Td2a8ffget_available_versionsTb4b4b4(Tb4b4b4)Tb4b4b4) Tff7b72> T79c0ff0

Tb4b4b4)

Tff7b72def Td2a8ffupdate_docsTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3versionTff7b72=Ta5d6ff"Ta5d6fflatestTa5d6ff"Tb4b4b4)Tb4b4b4:

Tff7b72if Tb4b4b4(

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72== Ta5d6ff"Ta5d6ffdownloadingTa5d6ff"

Tff7b72or Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72== Ta5d6ff"Ta5d6ffextractingTa5d6ff"

Tb4b4b4)Tb4b4b4:

Tff7b72return Tff7b72False

Te6edf3thread Tff7b72= Te6edf3threadingTff7b72.Td2a8ffThreadTb4b4b4(Te6edf3targetTff7b72=Tff7b72selfTff7b72.Td2a8ff_download_taskTb4b4b4, Te6edf3argsTff7b72=Tb4b4b4(Te6edf3versionTb4b4b4,Tb4b4b4)Tb4b4b4)

Te6edf3threadTff7b72.Td2a8ffdaemon Tff7b72= Tff7b72True

Te6edf3threadTff7b72.Td2a8ffstartTb4b4b4(Tb4b4b4)

Tff7b72return Tff7b72True

Tff7b72def Td2a8ff_download_taskTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3versionTff7b72=Ta5d6ff"Ta5d6fflatestTa5d6ff"Tb4b4b4)Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6ffdownloadingTa5d6ff"

Tff7b72selfTff7b72.Td2a8ffdownload_progress Tff7b72= T79c0ff0

Tff7b72selfTff7b72.Td2a8fflast_error Tff7b72= Tff7b72None

T8b949e# Get URLs from config

Te6edf3urls_str Tff7b72= Tff7b72selfTff7b72.Td2a8ffconfigTff7b72.Td2a8ffdocs_download_urlsTff7b72.Td2a8ffgetTb4b4b4(Tb4b4b4)

Te6edf3urls Tff7b72= Tb4b4b4[Te6edf3uTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4) Tff7b72for Te6edf3u Tff7b72in Te6edf3urls_strTff7b72.Td2a8ffreplaceTb4b4b4(Ta5d6ff"Tffea00\nTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff,Ta5d6ff"Tb4b4b4)Tff7b72.Td2a8ffsplitTb4b4b4(Ta5d6ff"Ta5d6ff,Ta5d6ff"Tb4b4b4) Tff7b72if Te6edf3uTff7b72.Td2a8ffstripTb4b4b4(Tb4b4b4)Tb4b4b4]

Tff7b72if Tff7b72not Te6edf3urlsTb4b4b4:

Te6edf3urls Tff7b72= Tb4b4b4[Ta5d6ff"Ta5d6ffhttps://git.quad4.io/Reticulum/reticulum_website/archive/main.zipTa5d6ff"Tb4b4b4]

Te6edf3last_exception Tff7b72= Tff7b72None

Tff7b72for Te6edf3url Tff7b72in Te6edf3urlsTb4b4b4:

Tff7b72tryTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffinfoTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffAttempting to download docs from Tffd700{Te6edf3urlTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3zip_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6ffwebsite.zipTa5d6ff"Tb4b4b4)

T8b949e# Download ZIP

Te6edf3response Tff7b72= Te6edf3requestsTff7b72.Td2a8ffgetTb4b4b4(Te6edf3urlTb4b4b4, Te6edf3streamTff7b72=Tff7b72TrueTb4b4b4, Te6edf3timeoutTff7b72=T79c0ff60Tb4b4b4)

Te6edf3responseTff7b72.Td2a8ffraise_for_statusTb4b4b4(Tb4b4b4)

Te6edf3total_size Tff7b72= Tffa657intTb4b4b4(Te6edf3responseTff7b72.Td2a8ffheadersTff7b72.Td2a8ffgetTb4b4b4(Ta5d6ff"Ta5d6ffcontent-lengthTa5d6ff"Tb4b4b4, T79c0ff0Tb4b4b4)Tb4b4b4)

Te6edf3downloaded_size Tff7b72= T79c0ff0

Tff7b72with Tffa657openTb4b4b4(Te6edf3zip_pathTb4b4b4, Ta5d6ff"Ta5d6ffwbTa5d6ff"Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Tff7b72for Te6edf3chunk Tff7b72in Te6edf3responseTff7b72.Td2a8ffiter_contentTb4b4b4(Te6edf3chunk_sizeTff7b72=T79c0ff8192Tb4b4b4)Tb4b4b4:

Tff7b72if Te6edf3chunkTb4b4b4:

Te6edf3fTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3chunkTb4b4b4)

Te6edf3downloaded_size Tff7b72+Tff7b72= Tffa657lenTb4b4b4(Te6edf3chunkTb4b4b4)

Tff7b72if Te6edf3total_size Tff7b72> T79c0ff0Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ffdownload_progress Tff7b72= Tffa657intTb4b4b4(

Tb4b4b4(Te6edf3downloaded_size Tff7b72/ Te6edf3total_sizeTb4b4b4) Tff7b72* T79c0ff90Tb4b4b4,

Tb4b4b4)

T8b949e# Extract

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6ffextractingTa5d6ff"

T8b949e# For automatic downloads from git, we'll use a timestamp as version if none provided

Tff7b72if Te6edf3version Tff7b72== Ta5d6ff"Ta5d6fflatestTa5d6ff"Tb4b4b4:

Tff7b72import T7ee787time

Te6edf3version Tff7b72= Ta5d6fffTa5d6ff"Ta5d6ffgit-Tffd700{Tffa657intTb4b4b4(Te6edf3timeTff7b72.Td2a8fftimeTb4b4b4(Tb4b4b4)Tb4b4b4)Tffd700}Ta5d6ff"

Tff7b72selfTff7b72.Td2a8ff_extract_docsTb4b4b4(Te6edf3zip_pathTb4b4b4, Te6edf3versionTb4b4b4)

T8b949e# Cleanup

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3zip_pathTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffremoveTb4b4b4(Te6edf3zip_pathTb4b4b4)

Tff7b72selfTff7b72.Td2a8ffconfigTff7b72.Td2a8ffdocs_downloadedTff7b72.Td2a8ffsetTb4b4b4(Tff7b72TrueTb4b4b4)

Tff7b72selfTff7b72.Td2a8ffdownload_progress Tff7b72= T79c0ff100

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6ffcompletedTa5d6ff"

T8b949e# Switch to the new version

Tff7b72selfTff7b72.Td2a8ffswitch_versionTb4b4b4(Te6edf3versionTb4b4b4)

Tff7b72return T8b949e# Success, exit task

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Te6edf3loggingTff7b72.Td2a8ffwarningTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to download docs from Tffd700{Te6edf3urlTffd700}Ta5d6ff: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Te6edf3last_exception Tff7b72= Te6edf3e

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6ffwebsite.zipTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffremoveTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6ffwebsite.zipTa5d6ff"Tb4b4b4)Tb4b4b4)

Tff7b72continue T8b949e# Try next URL

T8b949e# If we got here, all URLs failed

Tff7b72selfTff7b72.Td2a8fflast_error Tff7b72= Tffa657strTb4b4b4(Te6edf3last_exceptionTb4b4b4)

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6fferrorTa5d6ff"

Te6edf3loggingTff7b72.Td2a8fferrorTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffAll docs download sources failed. Last error: Tffd700{Te6edf3last_exceptionTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72def Td2a8ffupload_zipTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3zip_bytesTb4b4b4, Te6edf3versionTb4b4b4)Tb4b4b4:

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6ffextractingTa5d6ff"

Tff7b72selfTff7b72.Td2a8ffdownload_progress Tff7b72= T79c0ff0

Tff7b72selfTff7b72.Td2a8fflast_error Tff7b72= Tff7b72None

Tff7b72tryTb4b4b4:

Te6edf3zip_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6ffuploaded.zipTa5d6ff"Tb4b4b4)

Tff7b72with Tffa657openTb4b4b4(Te6edf3zip_pathTb4b4b4, Ta5d6ff"Ta5d6ffwbTa5d6ff"Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3fTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3zip_bytesTb4b4b4)

Tff7b72selfTff7b72.Td2a8ff_extract_docsTb4b4b4(Te6edf3zip_pathTb4b4b4, Te6edf3versionTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3zip_pathTb4b4b4)Tb4b4b4:

Te6edf3osTff7b72.Td2a8ffremoveTb4b4b4(Te6edf3zip_pathTb4b4b4)

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6ffcompletedTa5d6ff"

Tff7b72selfTff7b72.Td2a8ffdownload_progress Tff7b72= T79c0ff100

Tff7b72selfTff7b72.Td2a8ffswitch_versionTb4b4b4(Te6edf3versionTb4b4b4)

Tff7b72return Tff7b72True

Tff7b72except Tf85149Exception Tff7b72as Te6edf3eTb4b4b4:

Tff7b72selfTff7b72.Td2a8fflast_error Tff7b72= Tffa657strTb4b4b4(Te6edf3eTb4b4b4)

Tff7b72selfTff7b72.Td2a8ffdownload_status Tff7b72= Ta5d6ff"Ta5d6fferrorTa5d6ff"

Te6edf3loggingTff7b72.Td2a8ffexceptionTb4b4b4(Ta5d6fffTa5d6ff"Ta5d6ffFailed to upload docs: Tffd700{Te6edf3eTffd700}Ta5d6ff"Tb4b4b4)

Tff7b72return Tff7b72False

Tff7b72def Td2a8ff_extract_docsTb4b4b4(Tff7b72selfTb4b4b4, Te6edf3zip_pathTb4b4b4, Te6edf3versionTb4b4b4)Tb4b4b4:

T8b949e# Target dir for this version

Te6edf3version_dir Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffversions_dirTb4b4b4, Te6edf3versionTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3version_dirTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Te6edf3version_dirTb4b4b4)

Te6edf3osTff7b72.Td2a8ffmakedirsTb4b4b4(Te6edf3version_dirTb4b4b4)

T8b949e# Temp dir for extraction

Te6edf3temp_extract Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Tff7b72selfTff7b72.Td2a8ffdocs_base_dirTb4b4b4, Ta5d6ff"Ta5d6fftemp_extractTa5d6ff"Tb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3temp_extractTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Te6edf3temp_extractTb4b4b4)

Tff7b72with Te6edf3zipfileTff7b72.Td2a8ffZipFileTb4b4b4(Te6edf3zip_pathTb4b4b4, Ta5d6ff"Ta5d6ffrTa5d6ff"Tb4b4b4) Tff7b72as Te6edf3zip_refTb4b4b4:

T8b949e# Gitea/GitHub zips have a root folder

Te6edf3namelist Tff7b72= Te6edf3zip_refTff7b72.Td2a8ffnamelistTb4b4b4(Tb4b4b4)

Tff7b72if Tff7b72not Te6edf3namelistTb4b4b4:

Tff7b72raise Tf85149ExceptionTb4b4b4(Ta5d6ff"Ta5d6ffZip file is emptyTa5d6ff"Tb4b4b4)

Te6edf3root_folder Tff7b72= Te6edf3namelistTb4b4b4[T79c0ff0Tb4b4b4]Tff7b72.Td2a8ffsplitTb4b4b4(Ta5d6ff"Ta5d6ff/Ta5d6ff"Tb4b4b4)Tb4b4b4[T79c0ff0Tb4b4b4]

T8b949e# Check if it's the reticulum_website repo (has docs/ folder)

Te6edf3docs_prefix Tff7b72= Ta5d6fffTa5d6ff"Tffd700{Te6edf3root_folderTffd700}Ta5d6ff/docs/Ta5d6ff"

Te6edf3has_docs_subfolder Tff7b72= Tffa657anyTb4b4b4(Te6edf3mTff7b72.Td2a8ffstartswithTb4b4b4(Te6edf3docs_prefixTb4b4b4) Tff7b72for Te6edf3m Tff7b72in Te6edf3namelistTb4b4b4)

Tff7b72if Te6edf3has_docs_subfolderTb4b4b4:

Te6edf3members_to_extract Tff7b72= Tb4b4b4[Te6edf3m Tff7b72for Te6edf3m Tff7b72in Te6edf3namelist Tff7b72if Te6edf3mTff7b72.Td2a8ffstartswithTb4b4b4(Te6edf3docs_prefixTb4b4b4)Tb4b4b4]

Tff7b72for Te6edf3member Tff7b72in Te6edf3members_to_extractTb4b4b4:

Te6edf3zip_refTff7b72.Td2a8ffextractTb4b4b4(Te6edf3memberTb4b4b4, Te6edf3temp_extractTb4b4b4)

Te6edf3src_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3temp_extractTb4b4b4, Te6edf3root_folderTb4b4b4, Ta5d6ff"Ta5d6ffdocsTa5d6ff"Tb4b4b4)

T8b949e# Move files from extracted docs to version_dir

Tff7b72for Te6edf3item Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Te6edf3src_pathTb4b4b4)Tb4b4b4:

Te6edf3s Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3src_pathTb4b4b4, Te6edf3itemTb4b4b4)

Te6edf3d Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3version_dirTb4b4b4, Te6edf3itemTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3sTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopytreeTb4b4b4(Te6edf3sTb4b4b4, Te6edf3dTb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopy2Tb4b4b4(Te6edf3sTb4b4b4, Te6edf3dTb4b4b4)

Tff7b72elseTb4b4b4:

T8b949e# Just extract everything directly to version_dir, but remove root folder if exists

Te6edf3zip_refTff7b72.Td2a8ffextractallTb4b4b4(Te6edf3temp_extractTb4b4b4)

Te6edf3src_path Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3temp_extractTb4b4b4, Te6edf3root_folderTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3src_pathTb4b4b4) Tff7b72and Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3src_pathTb4b4b4)Tb4b4b4:

Tff7b72for Te6edf3item Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Te6edf3src_pathTb4b4b4)Tb4b4b4:

Te6edf3s Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3src_pathTb4b4b4, Te6edf3itemTb4b4b4)

Te6edf3d Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3version_dirTb4b4b4, Te6edf3itemTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3sTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopytreeTb4b4b4(Te6edf3sTb4b4b4, Te6edf3dTb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopy2Tb4b4b4(Te6edf3sTb4b4b4, Te6edf3dTb4b4b4)

Tff7b72elseTb4b4b4:

T8b949e# Fallback if no root folder

Tff7b72for Te6edf3item Tff7b72in Te6edf3osTff7b72.Td2a8fflistdirTb4b4b4(Te6edf3temp_extractTb4b4b4)Tb4b4b4:

Te6edf3s Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3temp_extractTb4b4b4, Te6edf3itemTb4b4b4)

Te6edf3d Tff7b72= Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3version_dirTb4b4b4, Te6edf3itemTb4b4b4)

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffisdirTb4b4b4(Te6edf3sTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopytreeTb4b4b4(Te6edf3sTb4b4b4, Te6edf3dTb4b4b4)

Tff7b72elseTb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffcopy2Tb4b4b4(Te6edf3sTb4b4b4, Te6edf3dTb4b4b4)

T8b949e# Create a metadata file with the version name

Tff7b72with Tffa657openTb4b4b4(Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffjoinTb4b4b4(Te6edf3version_dirTb4b4b4, Ta5d6ff"Ta5d6ff.versionTa5d6ff"Tb4b4b4)Tb4b4b4, Ta5d6ff"Ta5d6ffwTa5d6ff"Tb4b4b4) Tff7b72as Te6edf3fTb4b4b4:

Te6edf3fTff7b72.Td2a8ffwriteTb4b4b4(Te6edf3versionTb4b4b4)

T8b949e# Cleanup temp

Tff7b72if Te6edf3osTff7b72.Td2a8ffpathTff7b72.Td2a8ffexistsTb4b4b4(Te6edf3temp_extractTb4b4b4)Tb4b4b4:

Te6edf3shutilTff7b72.Td2a8ffrmtreeTb4b4b4(Te6edf3temp_extractTb4b4b4)